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PREFACE: WHAT IS NODE.JS? 


JavaScript is a programming language that web browsers can 
run. Browsers like Firefox and Chrome are built with engines that 
can understand and execute programs written in the JavaScript 
language. Firefox has an engine called SpiderMonkey, and 
Chrome’s engine is called V8. 

Running JavaScript in a browser limits what you can do with 
it. For example, with JavaScript in a browser, you are limited to 
interacting with web pages. You can detect errors when people 
enter information in a form. You can open browser windows and 
alert boxes. But you can't control anything outside of a browser. 

Fortunately, you have another option. When you install and 
use the JavaScript extension Node.js, your JavaScript code can 
run independently of a web browser. (You’ll often see Node.js sim¬ 
ply called Node, and that’s what we'll do for the rest of this book.) 

Node is the V8 JavaScript engine bundled together with 
libraries that handle input/output and networking. This means 
that Node lets you use JavaScript outside of a browser to run 
shell scripts, manage back-end services, and run directly on 
devices. 

What You Bring to the Book 

* Basic familiarity with programming concepts 

* Ability to set up and connect a Raspberry Pi 

* Ability to access and use a console 

* Understanding of sudo, directories, and file creation/editing 



Meet JavaScript 
and Node.js! 


T his chapter takes you through the steps to install Node on 
your Mac, Windows, or Linux OS. Then you’ll check to see that 
it’s working. 


NOTE As you install Node, you may notice that something 
called npm is also being installed. This program is the Node 
Package Manager. 

Node is really popular, and it has a whole new ecosystem of use¬ 
ful Node-based code packages other developers have created 
for you to use. When you want to use one of these packages in 
Node, you need an easy way to install and manage them. That’s 
what npm does for you—it installs additional Node packages 
you want to use. 


Follow the instructions for your system; then jump to the last 
section, “Node Is Installed; Now What?” 






INSTALL NODE ON MAC 


Although you could build Node from the source code, this guide 
is all about getting you going quickly. The easy way is to visit the 
official Node website, Nodejs.org, and use an automated installer. 
Here are the steps involved: 

Step 1. Visit nodejs.org/en/download/ and click the Macintosh 
Installer button to download the installer (Figure 1.1). 



FIGURE 1.1: Nodejs.org download page 


Step 2. Find the file you downloaded and double-click it. You’ll 
see the installation dialog (Figure 1.2). Click Continue to go 
through the installation. Stick with the default settings. 

Step 3. When the installation finishes, you’ll see a summary 
screen with installation information (Figure 1.3). 
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FIGURE 1.2: Node installer 



FIGURE 1.3: Node installer summary 


Step 4. You need to make sure that /usr/local/bin is in your 
PATH environment variable. To do this, open the Terminal.app 
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program—you can find it under /Applications/Utilities. Start 
the Terminal program. In the new terminal window, type 


This will return a list of directory paths, separated by colons. 
In my case, I get this output: 

/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin 

You can see that /usr/local/bin is the first thing in my 
PATH. If you don’t see it in yours, you'll need to add it. If you 
do see it, skip step 5. 

Step 5. Here’s how to add /user/local/bin to your PATH. In 
your terminal, type 

touch ~/.bash_profile 

This creates the file if it doesn’t already exist. Now type 

open ~/.bash_profile 

This opens the .bash_profile file in TextEdit. In TextEdit, add 
the line 

PATH=${PATH}:/usr/local/bin 

Save the .bash_profile file and quit TextEdit. 

You’ll need the changes you made to take effect. To do this, 
type this command in the terminal: 

Step 6. Let’s confirm that we have Node running. Type this 
command in your terminal to see the versions you’ve installed: 
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You’ll see output like this, giving you the version of Node 
that you just installed: 


V6.11.3 

Don’t worry if the version number is different from what you 
see here; new releases come out frequently. 

After confirming you have the Node program installed and 
working, you’re ready to start writing JavaScript. Leave this terminal 
open and skip ahead to the section “Node Is Installed; Now What?” 

INSTALL NODE ON WINDOWS 

You’ll start by visiting the official Node website, Nodejs.org, and 
getting the automated installer. Here are the steps involved: 

Step 1. Visit https://nodejs.org/en/download/ and click the 
Windows Installer button to download the installer (Figure 1.4). 
Pick the MSI file for either 32 bits or 64 bits, depending on your 
computer platform. 



FIGURE 1.4: Nodejs.org download page 
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Step 2. Find the file you downloaded and double-click it. You may 
get a warning dialog asking for permission to install. Click OK. 

The installation program opens (Figure 1.5). Click Continue 
to go through the installation. Stick with the default settings. 



Step 3. When the installation finishes, you’ll see a summary 
screen with installation information. Let’s confirm that we have 
Node running. Click your Start menu, and you should see two 
new menu items under Recently Added: Node.js and Node.js 
Command Prompt (Figure 1.6). 



FIGURE 1.6: Windows Start menu 
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Step 4. Click Node.js Command Prompt to open the prompt. 
You’ll see a terminal window open with this line: 

Your environment has been set up for using Node.js 6.11.3 (x64) 


Don’t worry if the version number is different from what you 
see here; new releases come out frequently. 

This confirms that you have the Node program installed and 
working. You now have everything you need to start writing 
JavaScript. Leave this terminal open and skip ahead to the sec¬ 
tion “Node Is Installed; Now What?” 


INSTALL NODE ON LINUX 

The easiest way to get going with Linux is to install a prebuilt 
binary package from the Nodejs.org website. 


NOTE If you’re an experienced Linux user, you may find it 
simplest to use the package manager for your particular Linux 
distro. You can find a rundown of those at nodejs.org/en/ 
download/package-manager. 


Step 1. Visit https://nodejs.org/en/download/. Download the 
32- or 64-bit file with a name like node-v6.ii.3-linux-x64.tar.xz 
where v6.n.3 is the current version (Figure 1.7). Be sure to save 
it in a directory you'll remember. I’m saving mine to my Downloads 
directory. 
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FIGURE 1.7: Linux download 


Step 2. This archive contains everything you’ll need and is 
organized into subdirectories. You can extract it where it needs 
to go by using these commands: 

~$ tar xz ~/Downloads/node-v6.11.3-linux-x64.tar.xz 


0 


NOTE If ~/bi n does not exist, you’ll need to create it first. 


D 


Step 3. Make sure you have your PATH set to find your Node 
installation. Edit your .bash_prof-ile file and include that line. 
You can do so with this command: 

PATH=$PATH:~/bin/node-v6.11.3-linux 
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or by editing your .bash_profile and adding this line: 

PATH=${PATH}: /usr/loca"l/bi n/node-v6.11.3-li nux 

Step 4. Use this command to check to see whether Node has 
been installed: 


and you should get output with the version number 

V6.11.3 


Don’t worry if the version number is different from what you 
see here; new releases come out frequently. 

This confirms that you have the Node program installed and 
working. You have everything you need to start writing JavaScript. 
Leave this terminal open and continue to the next section. 


NODE IS INSTALLED; NOW WHAT? 

At this point, you should have Node installed and a terminal or 
console window open. (From here on, we’ll just call it the terminal.) 

In the next chapter, you’ll write your first program, but let’s 
quickly try out the Node REPL. 


E The REPL is like a playground where you can try out 
JavaScript code. It’s installed along with Node. REPL stands for 
Read Eval Print Loop. The REPL gives you a quick and easy way 
to test your JavaScript code and fix any mistakes. 
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In your terminal, type node to start the Node REPL: 


Notice that your cursor has changed to a greater than sign (>). 
You're now interacting with the REPL. Let's output some text: 

> console.log('Hello World!'); 

Hello World! 
undefined 

If you’re getting an error of some kind, check your punctua¬ 
tion. Make sure you’ve got single quotes around the text and a 
semicolon at the very end of your code. 


f s 

Did You Get Back undefined ? 

Don’t worry if you did! You’re using a JavaScript function, which 
will always return undefined if it doesn’t have a return value 
(you’ll learn more about this later). For now, you can just ignore 
it. You haven’t made any mistakes. 


Now try this very handy . help command: 

> .help 

.break Sometimes you get stuck, this gets you out 
■clear Alias for .break 
•exit Exit the repl 
■help Show repl options 

•load Load JS from a file into the REPL session 

•save Save all evaluated commands in this REPL session to a file 


NOTE Commands starting with a period are talking to the 
REPL interface—they’re not JavaScript code. 
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And let’s close the REPL and get back to the regular com¬ 
mand prompt, using the .exit command: 


You’ve installed Node, and you know how to start up and quit 
the REPL. This means that you’re ready to learn some JavaScript. 
Chapter 2 awaits. 
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Getting into 
JavaScript 


ou played with the REPL at the end of the last chapter. Now 
you’ll begin learning JavaScript by writing code both in the REPL 
and into saved JavaScript files. 

STRINGS, MATH, AND THE REPL 

You’ve already used the REPL (also called the Node shell). If it 
isn't open, go ahead and launch it. In Windows, open a command 
prompt or click the Node.js Command Prompt that you installed 
in your Start menu. On Mac or Linux, open a terminal. 

Type node to start the REPL. Remember, you’re in the shell 
when the prompt changes to >. 

The REPL is handy as you learn JavaScript. You can test 
pieces of your JavaScript code before saving them to a file. When 
you make an error in the REPL, you’ll get immediate feedback. 


When You See... 


Try entering this incomplete command: 

> console.log( 

Instead of an error message, you’ll see this: 

This ellipsis means that the REPL is waiting for you to type more 
code to finish the command. If you get the ellipsis but you’re not 
sure why, you can break out of it by typing the REPL command 
-break. 




Let’s try making a deliberate mistake so you can see the feed¬ 
back you get from the REPL. 

Try this broken line of code: 

> console.log(It's broken) 

Although there are several things wrong with this code, you’ll 
get only one message at a time. Here’s the first error: 

console.log(It's broken); 

SyntaxError: Invalid or unexpected token 

Let's fix the first problem. If you look at the carets under the 
text it 1 s broken, you’ll see they start right under the single quote. 

In JavaScript, anytime you use a string of text, you need to put 
it in quotes. Otherwise, the REPL thinks those words are code. 
So now try this: 

> console.log('It's broken’); 

Argh! You get a hanging ellipsis. 

console.logCIt's broken'); 
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This time the REPL finds the beginning of the string, but it 
thinks the second quote is closing your text. It’s looking for a 
parenthesis to end the command. 

This is tricky. We want to use a quote in our string, but we 
need quotes around our string. The simple way to fix it is to use 
double quotes around the whole string so you can use the single 
quote in the string. 

Both single and double quotes can be used around strings 
of text: 

> console.logC'It's broken"); 

It's broken 

undefined 

(Remember, you can ignore the undefined!) 

You can put more than a single string of text in the parenthe¬ 
ses of the console. log function. Try these commands: 

> console.log( 1 Hello' +'world'); 

This command combines the two strings and outputs the sin¬ 
gle string Helloworld. If you want a space between the two words, 
you can use any of these three arguments in the parentheses; 
they’ll all work. 

'Hello '+'world 1 
1 Hello 1 +' world 1 
'Hello 1 *' '+'world' 

You won’t always be using strings, though—you’ll be using 
lots of numbers and variables. Here’s a quick look at some of your 
options; try them out. 

> console.log(42); 

> console.log(5 + 4); 

> console.log(5 * 4); 

Numbers don’t use quotes; the REPL recognizes them. And 
you can do math operations on them. 
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FUNCTIONS 


You've used your first built-in function, console.log. This simple 
function prints out whatever string or other value you put in 
parentheses. 

Now let’s write a function! A function is basically code that 
can be reused. There’s more to it than that, but you'll start with 
something simple. Try typing in the following function. (Don’t 
type the ellipsis; it indicates that the REPL is waiting for more 
code that you can enter on the next line. Press Enter/Return and 
use multiple lines.) 

> function countPets(){ 

var total = dogs + cats; return (total); 

... } 

Here’s what is going on in this function: 

function countPets(){ 

This line starts with the JavaScript keyword function so the 
REPL knows a function is coming. 

countPets() is the name of the function. Everything in the 
function goes inside curly braces. 

Next are two lines beginning with the JavaScript keyword var. 
It’s short for variable, and the lines are saying that the variable 
dogs is equal to 2 and the variable cats is equal to 1. 

The next line says that the variable total contains the sum of 
dogs and cats. 

The keyword return instructs the function to send back the 
value of total after the function finishes. 

To use the function, type this command: 

> countPetsQ; 

You’ll get back the sum of dogs and cats: 3. 
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Let’s make the function a little more reusable. Take a look at 
this code and see if you can guess what’s going on. 

> function countPets(dogs, cats){ 

... var total = dogs + cats; 

... return (total); 

... } 

Now try it! 

> countPets(5, 3); 

In this function, you’re passing in values that the function can 
use. Being able to add different values to the same code is part 
of what makes functions so useful! 

You’ve now had a taste of JavaScript code. Unfortunately, as 
soon as you end this REPL session, your functions will not be 
saved. It’s time to move out of the REPL and put your code into 
. js files so you can start simple and build on them. 

USING JAVASCRIPT FILES 

The REPL is great for testing, but you need to be able to save 
and reuse your code. You'll need a text editor so you can write 
and edit your JavaScript code and save it into a file. 

Start by creating a text file called fromfile. js. Put this code 
in your file and save it to a location you’ll remember: 

console.log('These words are from my .js file! 1 ); 

In your terminal, navigate to the same directory where your 
fromfile. js was saved and type this command on your command 
line (not in the REPL!): 

$ node fromfile.js 

Node will execute the code in your file and you’ll see the 
output on your screen. 
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MAKE A WEB SERVER 


Now that you can save . js files, you can start exploring the real 
power of Node. Without Node, you can write JavaScript code 
that would run only on an existing web server. But Node frees you 
from those browsers and lets you create your own web server! 

It's easy to create a little web server with Node. Begin by 
creating a file called easyserver. js and save this code in it: 
var http = require('http 1 ); 

var server = http.createServer(function(req, res) { 
res.writeHead('I created this server! 1 ); 
res.endQ; 


server.listen(8080); 

Now try running your server. I’ll explain this code after you try 
it. In your terminal, visit the command line in the directory where 
you saved the file. Type 

$ node easyserver.js 

The terminal will seem to hang, but that's fine—it means your 
server is running! 

Open a browser and visit the URL localhostiseso. You should 
see the line I created this server! (Figure 2.1). 


localhost:8080/ 

■\±- 


^ j © localhost:8080 

e » 

= 

I created this server! 


FIGURE 2.1: A web page with output from your web server 

After you visit the web page, press Ctrl-C in your terminal to 
end the program. 
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Let’s take a closer look at what’s going on in this code. I don’t 
expect you to understand it right now. I’ve added comments to 
the original code. Just try to get the gist of it! 

var http = require('http 1 ); 

var server = http.createServer(function(req, res) { 

//send response to client 
res.writeHeadC'I created this server! 1 ); 

// finish the response 
res.end(); 

}); 

//the web server is listening on port 8080 

Node is doing most of the work for you with built-in code. The 
very first line is calling the http module, which, behind the scenes, 
has the code to turn your running program into a web server. 
The require keyword is giving the new variable http access to 
a whole lot of saved Node code and functions that can create a 
web server. 

In the second line, the code is calling a function called 
createServer. Whenever anyone connects to your web server, 
the code in that function will be executed. 

The last line tells the server you created to start listening for 
incoming requests on a particular port (in this case, 8080). 


Comments in Your Code 

The double slashes you saw in the last code example let you 
add comments to your code. Node ignores any words following 
the //. Comments are great for helping you remember what 
you did in your code. 


In the next chapter, you’ll begin using JavaScript to build a 
Twitter bot! 
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Creating a Node 
Twitter Bot on 
Raspberry Pi 


ou’ve written your first JavaScript program. Next, you’ll 
learn how to create a Twitter bot with Node that can run on any 
machine that has Node installed, including your Raspberry Pi. 

By now, you should already have Node installed on your sys¬ 
tem. This chapter will take you through the steps you need to 
set up and authorize a Twitter account, connect that account to 
a JavaScript program, and use the twit nmp module in your pro¬ 
gram to do most of the work. 

CREATE AND AUTHORIZE YOUR 
TWITTER ACCOUNT 


If you don’t have a Twitter account for your bot, create one at 
Twitter.com. 


Do You Use Gmail? 


Twitter accounts are based off unique email addresses. If you 
don’t have a spare email address but you use Gmail, you can 
save the hassle of creating a new email address with a handy 
trick. Gmail lets you add a plus sign and a few letters to your 

For example, if your Gmail address is j ane-doe@gmai l. com, you can 
create other email addresses like j anedoe+twitterbot@gmail. com 
or janedoe+catbot@gmail.com. 

Twitter will think this is a new address, but Gmail will place 
everything sent to that address into your existing inbox. 

One interesting side effect: It’s relatively easy to set up a Gmail 
filter to label all messages sent to that address as “Twitterbot 
Email” or something similar. That way, you can see at a glance 
which emails have been sent to your bot. 




Step 1. Log into the Twitter account you’ll be using for your bot. 

Step 2. Visit apps.twitter.com and click the Create New App 
button. 

Step 3. You’ll be presented with a form to fill out (Figure 3.1). 
Complete all the fields. You can enter any website you wish, 
and make sure you type a URL in the callback field. Don’t worry 
too much about what you enter in the fields now; you can 
change the contents at any time. 

Step 4. Click the Developer Agreement check box and click 
Create Your Twitter Application. 

Step 5. You’ll now see a summary page. Click the Keys And 
Access Tokens tab (Figure 3.2). The keys on this page connect 
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your Twitter app to the Node bot program you’ll create later in 
this chapter. 
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Step 6. Scroll to the bottom of this page and click the Create 
My Access Token button. This page now displays an access 
token and access token secret (Figure 3.3). Leave this page 
open. Next up, you'll create a file in your terminal and copy and 
paste info from this page into it. 



In the next section, you’ll set up a directory, initialize it, and 
create a configuration file with the keys and tokens on this page. 


CREATE A CONFIGURATION FILE 

Open your terminal on the device where you installed Node. 

Create a new directory where you can keep all your new Twitter 
bot files. I’ll call mine newtwitbot. Navigate to your new directory: 

pigraspberrypi$ mkdir newtwitbot 
pigraspberrypi$ cd newtwitbot 
pigraspberrypi:-/newtwitbot $ 
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Our Twitter bot will use two files: config. js and index, js. Cre¬ 
ate them now with the touch command: 

pigraspberrypi:~/newtwitbot $ touch 
config.js index.js 
pigraspberrypi:~/newtwitbot $ Is 
config.js index.js 

We need to edit the config. js file with the Twitter keys for 
your app. Using the editor of your choice (I use nano), edit your 
config. js file as shown here. Substitute your keys in place of the 
xxxxx values: 

//config.js 

/* TWITTER APP CONFIGURATION 
consumer_key 
consumer_secret 




access_token: ' xxxxx', 
access_token_secret: 'xxxxx' 

} 

Now, the Twitter bot's configuration is complete. These four 
values will be unique for each Twitter application you create. 

CREATE THE TWITTER BOT 

Do you remember the npm application you installed along with 
Node? This handy application lets you reuse code other people 
have previously written. 

There’s already a Twitter code library called twit. We can 
import this library with npm and then use functions to make com¬ 
munication with Twitter much easier. 

To install this library, use this command: 

pigraspberrypi:~/newtwitbot $ npm install —save twit 
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You’ll see this output: 


npm notice created a lockfile as package-lock.json. You should 
commit this file. 

npm WARN newtwitbot@0.0.0 No description 
npm WARN newtwitbot@0.0.0 No repository field. 

+ twit@2.2.9 


After the twit package has finished installing, open the index, js 
file. We’ll start adding lines. (Don’t worry about the WARN lines! If 
we were building code to then store for other people to use, we 
would want to add a description. In this case, we aren’t.) 


^Building the index.js File 


If you get lost, don’t worry. The complete contents of the 
i ndex. j s file are listed at the end of this chapter. 


Open index.js in an editor and add these lines. They tell our 
bot to use the twit code and let the code access the Twitter 
application keys in the config. js file. 

// Dependencies 

var twit = require('twit 1 ), config = require('./config 1 ); 

Now under those lines, add the following: 

var Twitter = new twit(config); 

This line creates a variable called Twitter, a special object that 
has access to all the code in the twit library, as well as the keys 
we set up in the config. js file so that it can actually communicate 
with Twitter. (This is confusing, but think of this Twitter variable as 
a superhero. It's more than just a single value; it can access lots of 
custom functions built to do things with Twitter like post, retweet, 
and favorite. This will be clearer by the end of the chapter.) 
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Next we’ll get to the heart of our bot. We’ll start by making 
it find tweets that contain the text strings doggo or pupper. Then 
it will use the console.log function you’ve already seen and post 
any found tweets to your terminal. 

Add this function, called retweet, to your index, js file: 

var retweet = function() { 
var params = { 

q: 'doggo OR pupper 1 , 
result.type: 'recent' 

} 

Twitter.get('search/tweets', params, function(err, data) { 

// if there no errors 
if ('err) { 

// grab ID of tweet to retweet 

var retweetld = data.statuses[0].id_str; 

// Tell Twitter to retweet 

Twitter.post( 1 statuses/retweet/:id 1 , 

{ 

id: retweetld 


:tion(err, response) { 

: (response) { 

console.log('Retweeted!!!'); 

console.log('Error tweeting'); 


} 


//if unable to Search a tweet 
else { 

console.log('Error searching'); 


There’s a lot going on here. This entire block of code is a 
single function. We’ll take a closer look in a minute, but let’s get 
it working and try it first. 
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If you tried to run this code right now, it wouldn’t actually do any¬ 
thing. You’ve written a function, but you haven’t added any code that 
will call it. Let’s do that now. At the end of this code, add these lines: 

retweetQ; 

II retweet every 3 minutes 
setlnterval(retweet, 180000); 

Now we’re calling our function every 180,000 milliseconds, 
or every 3 minutes. Change this to whatever interval you wish. 


WARNING If you run your bot too frequently, Twitter will 
see that you’re using up too many resources and will “rate-limit” 
you. Once every 3 minutes is plenty. 


It’s time to try the program. Open your bot’s Twitter feed in 
a web browser. Now in your terminal, run your program by using 
this command: 

pigraspberrypi:-/newtwitbot $ node index.js 

You’ll see lots of output! All the info about each tweet that 
matches your search string is displayed on your terminal. It is also 
retweeted to your bot’s Twitter account. 


^Customize Your Own Search ^ 

It’s not likely that you’ll want to keep searching for and retweet¬ 
ing doggo and pupper tweets! You can change the query string 
(the text in quotes after q:) to look for any terms you wish, 
including hashtags. Separate multiple terms with commas. The 
argument result_type: 1 recent' tells the code to search for 
the latest tweets since our bot last retweeted. You can find more 
parameters for this query string by checking out the Twitter API 
reference at dev.twitter.com/rest/reference/get/search/tweets. 
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Your program will keep running and retweeting every 3 min¬ 
utes until you stop it by pressing Ctrl-C. 

Let’s take a closer look. Consider this code: 

> 

This code sets up the parameters of the data we’ll be search¬ 
ing for. 

Here’s the code that uses those parameters, starting with the 
Twitter.get function. This function comes from the twit API, and 
it takes three objects: 

* The action we want it to take-in this case we want it to 
search, so we use search/tweets. 


* The params object (our query string and any other params). 

* A callback function that calls another twit API function, 
Twitter.post. This function does the actual posting or 
reports errors. 


Twitter.get('search/tweets', params, function^ 
// if there no errors 
if (! err) { 

// grab ID of matching tweet 

var retweetld = data.statuses[0].id_str; 

{id: retweetld}, 


console.log('Retweeted this tweet 1 ; 
console.log(data); 
retweeting.'); 


// error while retweeting 
if (err) { 

console.log('Error tweeting';}); 

} 

// if unable to search through tweets 
else { 


data) { 
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console.log('Er 


searching.'); 


}); 

} 

The last bit of code we added uses a JavaScript timer func¬ 
tion, setlntervalQ. This timer function calls the retweet function 


We’ve covered quite a bit of ground in this chapter. Here’s the 
entire index, js code so fan 


Twitter.get( 1 search/tweets 1 , params, function(err, data) { 


if C!err) { 

// grab ID of 
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// if unable to Search a tweet 
else { 

console.log('Error searching'); 


// retweet every 3 minutes 
setlnterval(retweet, 180000); 

In the next chapter, we’ll expand on the bot’s functionality 
and use the Raspberry Pi to make an LED light up when our bot’s 
Twitter handle is mentioned! 


Creating a Node Twitter Bot 


Raspberrg 




Flash an LED in 
Response to a 
Twitter Event 


ou've created your Twitter bot with Node. If you’ve set it up 
on your Raspberry Pi, you can hook up an LED and make it flash 
when an event happens on Twitter. 

In this chapter, you’ll wire up an LED on a breadboard hooked 
in to your Pi. Next, you’ll write a short program that will make 
the LED blink twice. Finally, you’ll add this code to your Twitter 
bot program so that each time your bot’s Twitter handle is men¬ 
tioned, the LED will alert you by blinking (Figure 4.1). 



SET UP THE LED ON YOUR 
RASPBERRY PI 

The setup, shown in Figure 4.2, is fairly simple. 

Here’s what you’ll need: 

* Raspberry Pi with 5V power supply 

* Breadboard 

* 2 male-to-female jumper cables (the example uses black 
and green) 

* An LED 

Step 1. Locate the GPIO pins on your Pi (Figure 4.3). 
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FIGURE 4.2: Complete LED setup on Raspberry Pi 



FIGURE 4.3: Close-up of GPIO pins 
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What Do You Mean by GPIO? 


See those 26 pins along one edge of your Pi? Seventeen of 
these pins are called GPIO, short for General Purpose Input/ 
Output. You can attach external hardware to these pins. The 
other pins are power or ground pins. 




Step 2. Connect the female end of the green jumper cable to 
pin 4 of the GPIO on the Pi, as shown in both Figures 4.1 and 4.2. 

Step 3. Connect the female end of the black jumper cable to 
pin 3 of the GPIO. 

Step 4. Take a look at your LED. One leg is longer than the 
other. The longer leg is the plus side, and the shorter leg is the 
minus terminal. This is important to keep track of. 

Step 5. Insert your LED into the breadboard as shown in Fig¬ 
ure 4.2. Make sure the plus side of the LED is on the right. 

Step 6. Connect the male end of the black cable to the bread¬ 
board adjacent to the minus terminal of the LED. If any of this is 
confusing, just take a close look at Figure 4.2. 

Step 7. Connect the male end of the green cable to the bread¬ 
board adjacent to the plus terminal of the LED. 

Your Pi will now be able to blink the LED in response to the 
code you’re about to write! 


CREATE THE BLINK PROGRAM 


Open your terminal and connect to your Pi. Navigate to the 
directory where you created your Twitter bot files. 

pigraspberrypi$ cd newtwitbot 
pigraspberrypi:~/newtwitbot $ 
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Remember using npm to install the Twitter code library called 
twit? We’re going to use npm again, this time to import another 
library called onoff that lets us control the LED. 

To install this library, use this command: 

After onoff has finished installing, create and open a new file, 
helloBlink. js. 

pigraspberrypi:-/newtwitbot $ nano helloBlink.js 

This opens the editor with a new blank file. Here’s the code 
to enter: 

//helloBlink.js 

var Gpio = require('onoff 1 ).Gpio, 
led = new Gpio(4, 'out'); 
var iv = setlnterval(function () £ 

led.writeSync(led.readSync() === 071:0) 

// Toggle state of the LED every half second 
setTimeout(function () { 
clearlnterval(iv); 
led.writeSync(0); 

// Turn LED off 

Led.unexportO ; 

}, 2000 ); 

// End blinking after 2 seconds 

Save this file. 

Now give it a try with the node command: 

pigraspberrypi:-/newtwitbot $ node helloBlink.js 

MAKE YOUR BOT DETECT YOUR 
TWITTER HANDLE 

Before your bot can blink in response to your Twitter handle 
being tweeted, it needs to be able to detect when that happens. 
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In this section, we’ll add some code that will tweet a greeting 
back to anyone who tweets your handle. 

In the last chapter, you created a Twitter bot in a program 
called index, js. Open index, js (or whatever you named your file) 
in an editor. We’ll add this new code to the end of the current file. 
Make sure you change @doggothebotto to whatever you named 
your bot! 

{ track: ['gdoggothebotto'] }); 

//Look for my @name 

stream.on('tweet', tweetEvent); 

function tweetEvent(tweet) { 

// Get Twitter handle of who tweeted me 
var name = tweet.user.screen_name; 

// Now send a reply back to the sender 

var reply='You mentioned me! @' + name + ' ' + 'Bork bork!'; 


function(err, data,response) { 
if (err !== undefined) { 

//Report error if response tweet fails 
console.log(err); 

} else { 

//Report success 

console.log('Tweeted: ' + params.status); 

} 

}) 


Basically, this code listens for your bot’s Twitter handle. When 
it detects your handle, it grabs the handle of the sender. Then it 
creates a reply that includes the sender’s handle, and tweets it. 
In our example, if someone—let’s call her glynnbeighley—were to 
tweet anything containing my bot’s name, gdoggothebotto, the bot 
will respond with You mentioned me! glynnbeighley Bork bork!. 
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MAKE YOUR BOT BLINKTHE LED 
WHEN MENTIONED 


The last step is to add in the code you used in the helloBlink. js 
program at the correct point in your bot program. You can copy 
and paste it immediately after this line: 

console.log('Tweeted: 1 + params.status); 

The complete block of code we added to the end of your bot 
code in this chapter is 

//Respond when someone mentions me, gdoggothebotto 

{ track: ['gdoggothebotto'] }); 

//Look for my @name 

stream.on('tweet', tweetEvent); 

function tweetEvent(tweet) { 

var name = tweet.user.screen_name; 

// Now send a reply back to the sender 

var reply='You mentioned me! @' + name + ' ' + 'Bork bork!'; 
var params = { 

status: reply, in_reply_to_status_id: namelD 

}; 

Twitter.post('statuses/update', params, 
function(err, data,response) { 
if (err !== undefined) { 

//Report error if response tweet fails 
console.log(err); 

} else { 

//Report success 

console.log('Tweeted: ' + params.status); 
var Gpio = require('onoff').Gpio, 
led = new Gpio(4, 'out'); 
var iv = setInterval(function () { 

led.writeSync(led.readSync() === 0 ? 1 : 0) 

}, 500); 

// Toggle state of the LED every half second 
setTimeout(function () { 
clearlnterval(iv); 
led.writeSync(0); 

// Turn LED off 
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led.unexportO ; 

}, 2000 ); 

// End blinking after 2 seconds 

| 

}) 


You’ve now got a bot that not only responds when someone 
tweets at it, but also blinks an LED to let you know! Using similar 
techniques, you could monitor Twitter for more practical search 
terms—for example, the words tsunami and earthquake. 


Run Node Applications in the 
Background 


If you’re running something like a Twitter bot on your Pi, you’ll 
probably want to let it run in the background. You can use the 
command forever to do this. 

Use npm to install forever: 

pi@raspberrypi $ npm install forever —global 


Now you can run it like this: 

pi@raspberrypi$ forever start yourProgram.js 


Your program will 


V 


process. To stop it, 

p yourProgram.js 


this: 


J 


NODE, PI, AND THE INTERNET OF 
THINGS 

You've now had a jumpstart into JavaScript with Node and Rasp¬ 
berry Pi. You can control real-world devices and interact with 
the Internet. Blinking an LED is just a small taste of what you can 
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directly control with your Raspberry Pi. Now that you can do that, 
you can connect and control other, more interesting electronic 
devices. 

For example, you could attach a temperature sensor and 
periodically post environmental readings to a web page. Or you 
could use a motion sensor and set up an alert to catch your cat 
jumping up on your counter at night. 

Now it’s up to you to dream up and build your own JavaScript/ 
Node/Pi projects! 
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